home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 2 / CU Amiga Magazine's Super CD-ROM 02 (1996)(EMAP Images)(GB)[!][issue 1996-04].iso / magazine / amiga_e / e_update_v3.2e / edbg.readme < prev    next >
Text File  |  1994-11-08  |  3KB  |  120 lines
  1.  
  2. EDBG v3.2e
  3.  
  4. bugs fixed:
  5. - an enforcer hit (caused by EasyGUI :-)
  6. - is now 100% sysihack friendly
  7. - all windows now properly open on the public screen specified
  8.  
  9. features:
  10. An Arexx-port was added to EDBG! (name: "EDBG"), see command list below.
  11.  
  12. Also EDBG allows for saving of prefs (which, incidentally,
  13. it does by saving an arexx-script, and running it again on startup).
  14. It will save specific prefs for every project, remember window
  15. positions (if you want to), and also variables you were watching!
  16.  
  17. Select 'Settings...', and after that 'Save Settings'. You may
  18. add optional Arexx-scripts that can be launched directly from
  19. EDBG's 'Rexx' menu. The saved script is '.edbg-startup.rexx'
  20. in the current dir, which you are encouraged to examine and modify.
  21.  
  22. currently supported EDBG Arexx commands:
  23.  
  24.     QUIT
  25.  
  26. emergency exit (raising an exception is friendlier).
  27.  
  28.     STEPIN
  29.     STEPOVER
  30.     RUN
  31.  
  32. step in/over and run to breakpoint. only actually performed when
  33. control returns to the debugged program.
  34.  
  35.     EVAL exp
  36.  
  37. allows you to evaluate an E expression. You may use variables
  38. from the scope that is currently being debugged (much like
  39. 'Eval E Expression' from the menu). Nearly all Arexx commands
  40. that expect integer arguments can use similar expressions to EVAL.
  41. This is the only command that returns something in the rexx
  42. variable "rc" (the value of the expression). example:
  43.  
  44. 'eval {a}+(b*4)'
  45. say 'rc =' rc
  46.  
  47. you might need to fiddle with "options failat". Note closely
  48. how these to get their variables from entirely different scopes:
  49.  
  50. 'eval a+b'
  51. 'eval' a+b
  52.  
  53. (from Arexx (!))
  54.  
  55.     BREAKPOINT linenum
  56.  
  57. sets the breakpoint to that linenumber (in the current view).
  58.  
  59.     MEMORYBREAKPOINT addr
  60.  
  61. sets a memory breakpoint on that address. example:
  62.  
  63. 'memorybreakpoint {a}'
  64. 'run'
  65.  
  66. runs to the spot where variable "a" gets modified.
  67.  
  68.     RAISE exception exceptioninfo
  69.  
  70. raises that exception in the debugged program.
  71.  
  72.     ASSIGN varname exp
  73.  
  74. modifies a variable in the current scope. example:
  75.  
  76. 'assign a a+1'
  77.  
  78. increases "a" by one.
  79.  
  80.     WATCH varname varname ...
  81.  
  82. may be followed by any number of variable names. these will be
  83. inserted into the list of watched variables, which will then
  84. automatically be shown whenever you get to the scope that
  85. contains those variables.
  86.  
  87.     MEMORY exp
  88.  
  89. opens a memory window on the address denoted by exp. doesn't
  90. check for validity of the address.
  91.  
  92.     VARIABLES left top width height
  93.  
  94. opens the variable view window on that particular spot on the
  95. EDBG screen. If it was already open, it will resize it if
  96. necessary.
  97.  
  98.     SRCWINDOW srcname left top width height
  99.  
  100. same for the source view of source "srcname"
  101.  
  102.     NOABOUT
  103.  
  104. prevents the about window from popping up
  105.  
  106.     NOREFRESH
  107.  
  108. will not refresh memory windows etc. at every step
  109.  
  110.     REXX n script
  111.  
  112. sets up the arexx script "script" for launching within EDBG,
  113. from menu item "n".
  114.  
  115.  
  116. [note: if you want EDBG to make debugging steps during the
  117.  execution of your scripts, you should launch them with 'rx',
  118.  as those launched from EDBG execute the whole script before
  119.  returning to the debugged program]
  120.